home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / web / spiderweb / ms-dos / whereis < prev   
Internet Message Format  |  1992-01-22  |  12KB
  1. From @pucc.PRINCETON.EDU:HHBODE@DOSUNI1.BITNET Wed Dec  4 10:27:13 1991
  2. Received: from Princeton.EDU (Princeton.EDU.) by fs.Princeton.EDU (4.0/1.105)
  3.     id AA15150; Wed, 4 Dec 91 10:27:12 EST
  4. Received: from pucc.Princeton.EDU by Princeton.EDU (5.65b/2.84/princeton)
  5.     id AA22962; Wed, 4 Dec 91 10:27:00 -0500
  6. Message-Id: <9112041527.AA22962@Princeton.EDU>
  7. Received: from PUCC.PRINCETON.EDU by pucc.PRINCETON.EDU (IBM VM SMTP V2R1)
  8.    with BSMTP id 7652; Wed, 04 Dec 91 10:26:37 EST
  9. Received: from DOSUNI1.BITNET by PUCC.PRINCETON.EDU (Mailer R2.08 R208007) with
  10.  BSMTP id 4355; Wed, 04 Dec 91 10:26:36 EST
  11. Received: from DOSUNI1 (HHBODE) by DOSUNI1.BITNET (Mailer R2.08) with BSMTP id
  12.  0546; Wed, 04 Dec 91 16:25:55 MEZ
  13. Date:         Wed, 04 Dec 91 16:24:12 MEZ
  14. From: Hans-Hermann Bode <HHBODE@DOSUNI1.BITNET>
  15. Subject:      PC implementation of Spidery WEB
  16. To: Norman Ramsey <nr@Princeton.EDU>
  17. Status: RO
  18.  
  19. Hello,
  20.  
  21. I like to let you know about a PC version of your Spidery WEB system that I
  22. implemented. In fact, it is an ANSI-C version also, as appropriate changes
  23. are provided and the PC-related stuff is conditional. The implementation is
  24. available as an archive file spiderpc.zip by anonymous ftp from
  25. dione.rz.uni-osnabrueck.de (in the directory /pub/msdos/tex/web) or from
  26. rusinfo.rus.uni-stuttgart.de (in the directory /soft/tex/web/spiderweb); it
  27. contains the original files (none of it was edited directly, but a few had
  28. to be renamed) and changefiles and makefiles for the PC version. For your
  29. information I append the file readme.pc from spiderpc.zip.
  30.  
  31. Hans-Hermann Bode
  32. Arbeitsgruppe Systemforschung, Universit\"at Osnabr\"uck
  33. Tel.: (49)-541-9692545
  34. e-mail: HHBODE@DOSUNI1.BITNET
  35.  
  36. ------------------------------------------------README.PC-from-SPIDERPC.ZIP---
  37.                                 -*-Text-*-
  38. This is the PC implementation of Norman Ramsey's Spidery WEB system,
  39. compiled and provided with changefiles and makefiles for PC-/MS-DOS by
  40. Hans-Hermann Bode <HHBODE@DOSUNI1.BITNET>. The changes are appropriate for
  41. ANSI-C compilers as well as for Turbo C++, where the latter are made
  42. conditional (they will become effective only if the symbol __TURBOC__ is
  43. defined, which automatically is the case when compiled with Turbo C++), so
  44. users of other systems with ANSI-C compilers might be interested also.
  45.  
  46. Note that---though the Spider programs itself now should be suitable for
  47. ANSI-C compilers---there is no Spidery ANSI-C WEB yet, i.e., a weave
  48. processor capable to typeset ANSI-C programs is missing (the provided
  49. ceeweave is intended for traditional C only---the tangle processor, on the
  50. other hand, causes no problem, so the make procedure is not affected by
  51. this). You could use the C++ version (ccweave) instead, but this will not
  52. recognize traditional comments (the /*...*/ form). A quick solution might be
  53. to take the C++ Spider source (./cc/cc.spi, see below) and to change the
  54. comment rule appropriately. Possibly, this will be the first exercise for
  55. you in generating a new Spidery WEB.
  56.  
  57. To install the system unpack the archive and reproduce the following
  58. directory structure:
  59.  
  60. .
  61. ./ada
  62. ./ada/make
  63. ./ada/ada.spi
  64. ./ada/stacks.web
  65. ./ada/new.spi
  66. ./ada/old.spi
  67. ./ada/pcmake.sh        *
  68. ./ada/pcmake.bat    *
  69. ./ada/adatangl.exe    +
  70. ./ada/adaweave.exe    +
  71. ./ada/adaweb.tex    +
  72. ./awk
  73. ./awk/awk.spi
  74. ./awk/make
  75. ./awk/tangle.c
  76. ./awk/nawk.spi
  77. ./awk/pcmake.sh        *
  78. ./awk/pcmake.bat    *
  79. ./awk/awktangl.exe    +
  80. ./awk/awkweave.exe    +
  81. ./awk/awkweb.tex    +
  82. ./awk/awktangl.c    +
  83. ./c
  84. ./c/local.gui
  85. ./c/make
  86. ./c/c.spi
  87. ./c/tangle.c
  88. ./c/pcmake.sh        *
  89. ./c/pcmake.bat        *
  90. ./c/ceetangl.exe    +
  91. ./c/ceeweave.exe    +
  92. ./c/cweb.tex        +
  93. ./c/ceetangl.c        +
  94. ./cc
  95. ./cc/make
  96. ./cc/cc.spi
  97. ./cc/pcmake.sh        *
  98. ./cc/pcmake.bat        *
  99. ./cc/cctangle.exe    +
  100. ./cc/ccweave.exe    +
  101. ./cc/ccweb.tex        +
  102. ./dijkstra
  103. ./dijkstra/binary.web
  104. ./dijkstra/make
  105. ./dijkstra/d.spi
  106. ./dijkstra/sp.web
  107. ./dijkstra/readme
  108. ./dijkstra/pcmake.sh    *
  109. ./dijkstra/pcmake.bat    *
  110. ./dijkstra/dtangle.exe    +
  111. ./dijkstra/dweave.exe    +
  112. ./dijkstra/dijkstra.tex    +
  113. ./larch
  114. ./larch/make
  115. ./larch/l.spi
  116. ./larch/lists.web
  117. ./larch/pcmake.sh    *
  118. ./larch/pcmake.bat    *
  119. ./larch/ltangle.exe    +
  120. ./larch/lweave.exe    +
  121. ./larch/larchweb.tex    +
  122. ./penelope
  123. ./penelope/make
  124. ./penelope/spiderma
  125. ./penelope/a.spi
  126. ./penelope/nesting.spi
  127. ./penelope/stacks.web
  128. ./penelope/proc-a.spi
  129. ./penelope/scan_ann.awk
  130. ./penelope/spimkfil.pc    *
  131. ./penelope/pcmake.sh    *
  132. ./penelope/pcmake.bat    *
  133. ./ssl
  134. ./ssl/make
  135. ./ssl/s.spi
  136. ./ssl/pcmake.sh        *
  137. ./ssl/pcmake.bat    *
  138. ./ssl/stangle.exe    +
  139. ./ssl/sweave.exe    +
  140. ./ssl/sslweb.tex    +
  141. ./doc
  142. ./doc/spiderma.aux
  143. ./doc/spiderwe.toc
  144. ./doc/makefile
  145. ./doc/cacm.aux
  146. ./doc/cacm.tex
  147. ./doc/abstract.tex
  148. ./doc/spiderma.tex
  149. ./doc/overview.aux
  150. ./doc/overview.tex
  151. ./doc/spiderwe.tex
  152. ./doc/descript
  153. ./master
  154. ./master/cycle.awk
  155. ./master/nodups.awk
  156. ./master/transche.awk
  157. ./master/pathopen.h_0
  158. ./master/multitan.ch
  159. ./master/common.web
  160. ./master/cycle.web
  161. ./master/webhead
  162. ./master/spider.awk
  163. ./master/webtail
  164. ./master/common.h_0
  165. ./master/newdefs.awk
  166. ./master/transche.lis
  167. ./master/pretty.awk
  168. ./master/pathopen.web
  169. ./master/make.pre
  170. ./master/webmakef
  171. ./master/common.c_0
  172. ./master/pathopen.c_0
  173. ./master/makefile
  174. ./master/spider.web
  175. ./master/junk.lis
  176. ./master/weave.web
  177. ./master/tangle.web
  178. ./master/makefile.pc    *
  179. ./master/pathopen.ch    *
  180. ./master/common.ch    *
  181. ./master/common.hch    *
  182. ./master/common.h    o
  183. ./master/tangle.ch    *
  184. ./master/weave.ch    *
  185. ./master/pathopen.h    +
  186. ./master/pathopen.c    +
  187. ./master/common.c    +
  188. ./master/common.obj    +
  189. ./master/pathopen.obj    +
  190. ./gawk210
  191. ./gawk210/gawk.exe
  192. ./gawk210/gawk.1
  193. ./gawk210/gawk.dvi
  194. ./gawk210/gawk.tex
  195. ./gawk210/texinfo.tex
  196. ./gawk210/problems
  197. ./gawk210/readme
  198. ./gawk210/copying
  199. ./readme
  200. ./copyrigh
  201. ./bugs
  202. ./webkerne.tex
  203. ./makefile
  204. ./readme.pc        *
  205.  
  206. The files marked with `*' are specific and essential for the PC
  207. implementation, those marked with `+' are the results of pcmake runs (see
  208. below) and are reproducible. The file marked with `o' will not be generated
  209. by pcmake but might be reproduced from masterfile ./master/common.h_0 and
  210. changefile ./master/common.hch by means of a tool like WMERGE or TIE (or by
  211. hand). All files with names ending in `_0' are renamed from the original
  212. distribution, because they are replaced by new ones. The file
  213. ./awk/nawk.spi, a Spider source for the new Awk language, is contributed by
  214. Erich Neuwirth. The directory ./gawk210 contains the GNU implementation of
  215. the Awk programming language, Version 2.10; the interpreter, gawk.exe, is
  216. used in the pcmake process. All other files come from the original
  217. distribution of Spidery WEB.
  218.  
  219. For more information on the Spider system see the file ./readme and the
  220. documentation in the directory ./doc. For the copyright policy on Spidery
  221. WEB consider the file ./copyrigh. For the same subject on GAWK pay attention
  222. to the file ./gawk210/copying. Unfortunately, I can't tell you where to get
  223. the source files of the PC implementation of GAWK 2.10, since I got the
  224. system myself exactly as it is in ./gawk210 (look in ./gawk210/readme for
  225. contact persons, if required).
  226.  
  227. Using Spidery WEB on a PC
  228. -------------------------
  229.  
  230. For your convenience, precompiled executables are provided with this
  231. distribution. So, all you have to do is the following:
  232.  
  233.   - Copy the file ./webkernel.tex to a directory where TeX looks for input
  234. files.
  235.  
  236.   - Pick up one or more of the directories ./ada, ./awk, ./c, ./cc,
  237. ./dijkstra, ./larch, and ./ssl that correspond to the languages you like to
  238. use (cc is actually c++ in the original distribution). Copy the TeX files
  239. (*web.tex) to your TeX-inputs directory, too, and copy the exe files
  240. (*tangle.exe and *weave.exe) to your binaries directory, i.e., a directory
  241. that is in the DOS PATH.
  242.  
  243.   - That's all!
  244.  
  245. Note that there are no executables in the ./penelope directory. This is due
  246. to the fact that GAWK hung up while processing ./penelope/proc-a.spi. I
  247. didn't fix this problem up to now.
  248.  
  249. Setting up new Spiders on a PC
  250. ------------------------------
  251.  
  252. If you want to build new Spidery WEBs or like to change existing ones,
  253. you'll need the following resources:
  254.  
  255.   - An Awk interpreter. As GAWK, Version 2.10, is included in this archive,
  256. you don't have to worry about. Notice that GAWK, Version 2.11, will not
  257. work. Other MS-DOS Awk interpreters have not been tested, but probably won't
  258. work also.
  259.  
  260.   - A C compiler. The executables and object files supplied herein were
  261. compiled with and the changefiles as well as ./master/makefile.pc are
  262. intended for Turbo C++, Version 1.01. Other MS-DOS C compilers may also
  263. work, but you might run into delicate problems with Microsoft C, Version
  264. 6.00.
  265.  
  266.   - A make utility (if you don't prefer to do the job by hand, which would
  267. be a hard one). The file ./master/makefile.pc is intended for Turbo Make,
  268. Version 3.0.
  269.  
  270.   - A lot of memory. The most storage-consuming process is the interpreting
  271. of the Spider source (*.spi) by GAWK. This will need about 550 to 575 KByte
  272. of memory available on your system, so remove all memory-resident programs
  273. that aren't really necessary.
  274.  
  275. The file ./master/makefile.pc provides a full automatic creation of a
  276. Spidery WEB for a certain language from a Spider source file (don't use the
  277. other makefiles in this distribution, they are not intended for PC-/MS-DOS).
  278. For flexibility, several macros have to be defined from the command line;
  279. read the comment at the beginning of the makefile for more information.
  280. Incidentally, a symbol CMD may be defined, in which case the
  281. makefile---besides the interpreter and compiler mentioned above---will use
  282. standard DOS file utilities only; default is to use Unix-like utilities like
  283. cp, sort, and rm.
  284.  
  285. Each of the language-specific directories contains a script file, pcmake,
  286. that calls ./master/makefile.pc appropriate for the major Spider source of
  287. the language in question (sometimes, alternative sources are provided;
  288. again, don't use the other make scripts, they won't call the right
  289. makefile). Actually, two versions of pcmake reside in each of these
  290. directories: pcmake.bat is a batch file for use with command.com, pcmake.sh
  291. is a shell script for use with a bourne shell like ms_sh. Because both
  292. command processors will run the corresponding script automatically, simply
  293. type `pcmake' if you use either of these.
  294.  
  295. It is assumed that bourne-shell users have the Unix-like file utilities
  296. mentioned above available, thus pcmake.sh will run the makefile without
  297. defining CMD, while pcmake.bat defines it. Besides, in both cases the make
  298. utility will be called under the name `tmake'. If one of these facts doesn't
  299. fit your needs, you have to edit pcmake.sh or pcmake.bat first.
  300.  
  301. The make procedure implies a call to both the tangle processors of the Awk
  302. and the C language (awktangle.exe and ceetangle.exe). Hence you must install
  303. those in your binaries directory before doing anything else. If for some
  304. reason you can't use the binaries provided, you have to recompile
  305. ./c/ceetangle.c, ./awk/awktangle.c, ./master/common.c, and
  306. ./master/pathopen.c (don't forget to define the symbol MSDOS from the
  307. command line) and link the resulting ceetangle.obj and awktangle.obj with
  308. the resulting object files of the ./master sources, respectively.
  309.  
  310. When you ever change ./master/pathopen.web or ./master/pathopen.ch, the make
  311. process will generate a new pathopen.h in the current directory. You should
  312. move this file to the ./master directory, so it will not be produced once
  313. more in subsequent runs until it is outdated again.
  314.  
  315. By taking all these suggestions into account, after editing one of the
  316. Spider sources you should delete the exe files from the directory in
  317. question and, from that directory, just say `pcmake'. If everything works
  318. alright, after a while you will get new executables *tangle.exe and
  319. *weave.exe and a new macro package *web.tex besides some intermediate files.
  320. You can remove the latter by saying `pcmake clean' (this will not affect the
  321. exe and tex files). If you ceate a Spidery WEB for a new language, you
  322. should take one of the pcmake files as a model to proceed with a similar
  323. procedure.
  324.                                     -H2B-
  325.  
  326.